Organizations

Manage your organizations to group sites, users, and resources under a single administrative unit.

Overview

Organizations are the top-level entity in Taruvi Cloud. They serve as containers for sites, team members, and billing. Each organization can have multiple sites and users with different roles and permissions.

---

Concepts

Organization

An organization represents a company, team, or project that groups related sites and users together. Each organization has its own set of members, invitations, and settings.

Organization Slug

A unique identifier for your organization used in URLs. The slug is automatically generated from your organization name and cannot be changed after creation.

Subscription Plan

The billing plan associated with your organization, which determines available features and resource limits.

---

Create an Organization

Create a new organization to start managing sites and team members.

1. Go to the Organizations page in the Dashboard.
2. Click Create New Organization.
3. Enter an Organization Name for your organization.
4. Click Create.

tip

Choose a descriptive name that represents your company or project. The system will automatically generate a URL-friendly slug from your name.

---

View Organization Details

1. Go to the Organizations page in the Dashboard.
2. Click on the organization you want to view.
3. The organization detail page shows:
   • Organization Name: The display name of your organization
   • Slug: The unique URL identifier (shown as @slug)
   • Subscription Plan: Your current billing plan
   • Description: Optional description of the organization

The organization page has three main tabs:

• Sites: Manage sites within the organization
• Users: Manage members and invitations
• Settings: Configure organization settings

---

Manage Sites

The Sites tab displays all sites belonging to your organization.

View Sites

1. Navigate to your organization in the Dashboard.
2. Click the Sites tab.
3. Each site card displays:
   • Site Name: The name of the site
   • Status: Current status (Active, Provisioning, Suspended)
   • Domain: The site's domain URL
   • Description: Site description
   • Created Date: When the site was created

Create a New Site

1. Click Create New Site in the Sites tab.
2. Fill in the site details in the dialog.
3. Click Create.

Access a Site

1. Find the site in the Sites tab.
2. Click the Manage button on the site card.
3. You will be redirected to the site management page.

---

Manage Users

The Users tab allows you to invite new members and manage existing ones.

Invitations Tab

View and manage pending and accepted invitations.

Send an Invitation

1. Navigate to your organization in the Dashboard.
2. Click the Users tab.
3. Click Invite people.
4. In the dialog:
   • Enter the Email Address of the person to invite
   • Optionally enter a Username suggestion
   • Select an Organization Role from the dropdown
   • Optionally add Site Access to grant permissions to specific sites
5. Click Send Invitation.

Filter Invitations

Use the filter chips to view:

• All: All invitations
• Pending: Invitations not yet accepted
• Accepted: Invitations that have been accepted

Resend an Invitation

1. Find the pending invitation in the list.
2. Click the Resend button.
3. A new invitation email will be sent.

Delete an Invitation

1. Find the invitation in the list.
2. Click the Delete (trash) icon.
3. Confirm by clicking Delete in the confirmation dialog.

Members Tab

View and manage users who have accepted invitations and are part of the organization.

1. Click on the Members sub-tab within Users.
2. View the list of all organization members.
3. Manage member roles and permissions as needed.

---

Organization Settings

Configure your organization's settings and information.

General Settings

1. Navigate to your organization in the Dashboard.
2. Click the Settings tab.
3. Click General in the sidebar.
4. Update the following fields:
   • Organization Name: Update the display name
   • Slug: View only (cannot be changed)
   • Description: Add or update the description
5. Click Save Changes.

Organization Status

View your organization's current status:

• Status: Active or Inactive
• Created: The date the organization was created
• Plan: Your current subscription plan

---

Delete an Organization

warning

This action cannot be undone. All associated data will be permanently removed, including all sites, memberships, and invitations.

1. Navigate to your organization in the Dashboard.
2. Click the Settings tab.
3. Click Danger Zone in the sidebar.
4. Click Delete Organization.
5. In the confirmation dialog, type the organization name to confirm.
6. Click Delete Organization Permanently.

What gets deleted:

• All organization memberships
• All sites and their data
• All invitations
• All organization permissions
• PostgreSQL schemas for sites

---

Configuration

Organization Roles

Role	Description	Typical Permissions
Organization Admin	Full control over the organization	Manage sites, users, billing, settings
App Developer	Develop and deploy applications	Create apps, manage functions, view sites
Viewer	Read-only access	View sites and resources

Site Permissions

When inviting users, you can grant access to specific sites with these permissions:

Permission	Description
view_site	Required for admin to see user's site assignments
access_site	Required for user to see and access sites in their dashboard

---

Limits

Resource	Limit
Organizations per user	Varies by plan
Sites per organization	Varies by plan
Members per organization	Varies by plan
Pending invitations	100

info

Need higher limits? Contact support to discuss your requirements.

---

Troubleshooting

Invitation not received

Problem: The invited user hasn't received the invitation email.

Solution:

1. Check the spam/junk folder.
2. Verify the email address is correct.
3. Use the Resend button to send a new invitation.
4. Ask the user to add noreply@taruvi.cloud to their contacts.

---

Cannot delete organization

Problem: The delete button is disabled or deletion fails.

Solution:

1. Ensure you are an Organization Admin.
2. Type the organization name exactly as shown in the confirmation field.
3. Check for any active resources that may need to be deleted first.

---

User cannot access sites

Problem: An invited user cannot see or access sites after accepting the invitation.

Solution:

1. Verify the user has been granted access_site permission for the specific site.
2. Check the invitation configuration in the Invitations tab.
3. Re-invite the user with the correct site permissions.

---

Related

• Sites
• Invitations
• Billing

Last Updated: January 2025